# 云云对接项目接口流程 

# API概览:基础功能 |类型|API|说明| |-|-|-| |1.Viot协议转换接口|/server/api/convert|第三方系统调用此接口转换协议，控制设备| |2.新增指令接口|/server/api/addBatch|调用此接口进行批量新增指令| |3.更新指令接口|/server/api/updateBatch|调用此接口进行批量更新指令| |4.删除指令接口|/server/api/del|调用此接口进行删除指令| |5.分页查询指令列表接口|/server/api/page|调用此接口进行分页查询指令列表|

# Viot协议转换接口 ## 请求参数 | 名称 | 说明 | 数据类型 | 长度 | 是否必选 | |-------------|----------------------------------|-------------|----|------| | originMfr | 源厂商的名称即协议转换的其中一方平台名称。 | String | | M | | targetMfr | 目标厂商的名称即协议转换的另一方平台名称。 | String | | M | | deviceType | 设备类型。为设备的PID。 | String | | M | | deviceNo | 设备序列号。可从小峰管家中获取设备的序列号。 | String | | M | | optType | 操作类型。 | String | | M | | domain | 转换目标iot域名 | String | | M | | url | 请求url | String | | M | | paramObject | 请求参数。具体参照API网站[API详情](https://developer.jftech...

# 新增指令接口 ## 请求参数 | 名称 | 说明 | 数据类型 | 长度 | 是否必选 | |---------------|-----------------------|--------|----|------| | actions | 行为列表 | List | | M | | ├─ originMfr | 源厂商的名称即协议转换的其中一方平台名称。 | String | | M | | ├─ targetMfr | 目标厂商的名称即协议转换的另一方平台名称。 | String | | M | | ├─ deviceType | 设备类型。为设备的PID。 | String | | | | ├─ optType | 操作类型。 | String | | | | ├─ url | 请求url | String | | | | ├─ param | 请求参数。 | String | | | | ├─ method | 请求方法，为“Post”或“Get” | String | | | | ├─ updateTime | 更新时间。 | Long | | | | createTim...

# 项目接口逻辑  ConvertController与PlatformIotRequestContext是组合关系，ConvertController不可以脱离PlatformIotRequestContext而独立存在，PlatformIotRequestContext被封装在ConvertController之中。ConvertController是接口传入的起始处，对参数做基础的有效性检验。而PlatformIotRequestContext是将参数与平台连接的桥梁。 PlatformIotRequestContext与AbstractPlatform是组合关系，AbstractPlatform被封装在PlatformIotRequestContext中...

# 数据库设计 ## 对应数据库 iot_cloud_access ## 表读写场景 数据读取的场景说明：查询已有的协议转换信息及设备信息 数据写入的场景说明：新增协议及设备 数据更新的场景说明：设备的协议状态发生变化 ## 表类型 协议转换信息表 ## 表结构说明 表名称：request_info 协议转换信息表 | 序号 | 字段名 | 数据类型 | 主键 | 非空 | 描述 | |----|-------------|--------------|----|----|-----------------------| | 1 | id | INT(11) | 是 | 是 | 主键 | | 2 | origin_mfr | VARCHAR(20) | 否 | 是 | 源厂商的名称即协议转换的其中一方平台名称。 | | 3 | target_mft | VARCHAR(20) | 否 | 是 | 目标厂商的名称即协议转换的另一方平台名称。 | | 4 | device_type | VARCHAR(40) | 否 | 是 | 设备类型 | | 5 | opt_type | VARCHA...

如何使用AK、SK调用开放平台接口 以[新增、注销用户数据](https://developer.jftech.com/docs/?menusId=1&siderid=9320415ae48642c98bfd26419d2ef3d5&lang=zh)为例  ### 构造请求头参数 ```java public static void main(String[] args) { //ak sk 从我的账户 访问密钥栏中获取 String ak = System.getenv().get("AK"); String sk = System.getenv().get("SK"); String reTime ...